package com.smart.community.work.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.smart.community.work.entity.Notification;
import com.smart.community.work.vo.NotificationVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 消息通知Mapper接口
 * 
 * 严格按照《Java后端SpringBoot代码开发规范_重构版.md》Mapper规范实现：
 * - 继承BaseMapper：获得基础CRUD方法
 * - 方法命名：使用动词+名词形式，语义明确
 * - 参数注解：使用@Param注解标注参数
 * - 返回类型：使用具体的返回类型，避免使用Object
 * - 完整注释：所有方法都有完整的JavaDoc注释
 * - 数据访问封装：Mapper层负责所有数据库操作
 * - SQL优化：编写高效的SQL语句
 * - 参数映射：正确使用MyBatis参数映射
 * - 结果映射：正确使用MyBatis结果映射
 * - 数据访问封装：Mapper层负责所有数据库操作
 * - SQL优化：编写高效的SQL语句
 * - 参数映射：正确使用MyBatis参数映射
 * - 结果映射：正确使用MyBatis结果映射
 *
 * @author Wu.Liang
 * @since 2025-01-30
 * @version 1.0.0
 */
@Mapper
public interface NotificationMapper extends BaseMapper<Notification> {

    /**
     * 分页查询消息通知
     *
     * @param page 分页参数
     * @param params 查询参数
     * @return 消息通知分页数据
     */
    IPage<NotificationVO> selectNotificationPage(Page<NotificationVO> page, @Param("params") Map<String, Object> params);

    /**
     * 根据接收人ID查询消息通知
     *
     * @param receiverId 接收人ID
     * @param propertyCompanyId 物业公司ID
     * @return 消息通知列表
     */
    List<NotificationVO> selectByReceiverId(@Param("receiverId") Long receiverId, @Param("propertyCompanyId") Long propertyCompanyId);

    /**
     * 根据发送人ID查询消息通知
     *
     * @param senderId 发送人ID
     * @param propertyCompanyId 物业公司ID
     * @return 消息通知列表
     */
    List<NotificationVO> selectBySenderId(@Param("senderId") Long senderId, @Param("propertyCompanyId") Long propertyCompanyId);

    /**
     * 查询未读消息数量
     *
     * @param receiverId 接收人ID
     * @param propertyCompanyId 物业公司ID
     * @return 未读消息数量
     */
    Integer selectUnreadCount(@Param("receiverId") Long receiverId, @Param("propertyCompanyId") Long propertyCompanyId);

    /**
     * 查询指定类型的未读消息数量
     *
     * @param receiverId 接收人ID
     * @param propertyCompanyId 物业公司ID
     * @param type 消息类型
     * @return 未读消息数量
     */
    Integer selectUnreadCountByType(@Param("receiverId") Long receiverId, 
                                  @Param("propertyCompanyId") Long propertyCompanyId,
                                  @Param("type") Integer type);

    /**
     * 查询用户指定时间段的消息通知
     *
     * @param receiverId 接收人ID
     * @param propertyCompanyId 物业公司ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 消息通知列表
     */
    List<NotificationVO> selectByReceiverIdAndDateRange(@Param("receiverId") Long receiverId, 
                                                       @Param("propertyCompanyId") Long propertyCompanyId,
                                                       @Param("startDate") LocalDate startDate, 
                                                       @Param("endDate") LocalDate endDate);

    /**
     * 查询紧急消息
     *
     * @param receiverId 接收人ID
     * @param propertyCompanyId 物业公司ID
     * @return 紧急消息列表
     */
    List<NotificationVO> selectUrgentNotifications(@Param("receiverId") Long receiverId, @Param("propertyCompanyId") Long propertyCompanyId);

    /**
     * 查询置顶消息
     *
     * @param receiverId 接收人ID
     * @param propertyCompanyId 物业公司ID
     * @return 置顶消息列表
     */
    List<NotificationVO> selectPinnedNotifications(@Param("receiverId") Long receiverId, @Param("propertyCompanyId") Long propertyCompanyId);

    /**
     * 查询过期消息
     *
     * @param currentTime 当前时间
     * @return 过期消息列表
     */
    List<NotificationVO> selectExpiredNotifications(@Param("currentTime") LocalDateTime currentTime);

    /**
     * 查询消息统计信息
     *
     * @param propertyCompanyId 物业公司ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 统计信息
     */
    Map<String, Object> selectNotificationStatistics(@Param("propertyCompanyId") Long propertyCompanyId,
                                                   @Param("startDate") LocalDate startDate,
                                                   @Param("endDate") LocalDate endDate);

    /**
     * 批量标记为已读
     *
     * @param ids 消息ID列表
     * @param receiverId 接收人ID
     * @return 更新数量
     */
    Integer batchMarkAsRead(@Param("ids") List<Long> ids, @Param("receiverId") Long receiverId);

    /**
     * 标记所有消息为已读
     *
     * @param receiverId 接收人ID
     * @param propertyCompanyId 物业公司ID
     * @return 更新数量
     */
    Integer markAllAsRead(@Param("receiverId") Long receiverId, @Param("propertyCompanyId") Long propertyCompanyId);

    /**
     * 根据关联业务查询消息
     *
     * @param relatedId 关联业务ID
     * @param relatedType 关联业务类型
     * @return 消息通知列表
     */
    List<NotificationVO> selectByRelatedId(@Param("relatedId") Long relatedId, @Param("relatedType") String relatedType);

    /**
     * 删除过期消息
     *
     * @param currentTime 当前时间
     * @return 删除数量
     */
    Integer deleteExpiredNotifications(@Param("currentTime") LocalDateTime currentTime);

    /**
     * 更新消息状态
     *
     * @param id 消息ID
     * @param isRead 是否已读
     * @param readTime 阅读时间
     * @param isPinned 是否置顶
     * @param isUrgent 是否紧急
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer updateStatus(@Param("id") Long id,
                        @Param("isRead") Integer isRead,
                        @Param("readTime") LocalDateTime readTime,
                        @Param("isPinned") Integer isPinned,
                        @Param("isUrgent") Integer isUrgent,
                        @Param("updateBy") Long updateBy);

    /**
     * 批量更新消息状态
     *
     * @param ids 消息ID列表
     * @param isRead 是否已读
     * @param readTime 阅读时间
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer batchUpdateStatus(@Param("ids") List<Long> ids,
                             @Param("isRead") Integer isRead,
                             @Param("readTime") LocalDateTime readTime,
                             @Param("updateBy") Long updateBy);

    /**
     * 删除消息
     *
     * @param id 消息ID
     * @param updateBy 更新人ID
     * @return 删除数量
     */
    Integer deleteById(@Param("id") Long id, @Param("updateBy") Long updateBy);

    /**
     * 批量删除消息
     *
     * @param ids 消息ID列表
     * @param updateBy 更新人ID
     * @return 删除数量
     */
    Integer batchDelete(@Param("ids") List<Long> ids, @Param("updateBy") Long updateBy);
}
